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!• INTRODUCTION 



This document is the GDS for the Operator 
Communications System (later referred to as OCS) for 
IPL/OS. 

The functions described are the basic capabilities of- 
the system. As the OS requirements for operator 
communications services become better defined^ these 
capabilities will be extended. It is expected that most of 
the additional capability will be in the form of additional 
commands. 
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2.0 GENERAL SYSTEM DESCRIPTION 
2.2 CLASSES OF OPERATORS 



2. G ENERA L SYSTEM DESCRIPTION 



2.1 0£.SJ£N_jQBi£aiI^£S 



The primary objective of the Operator Coimunications 
System (OCS) is to provide a facility whereby both the 
system and users may converse with the human operator(s) of 
the system or network. Soecific objectives of this design 
are as fol lows. 

. The system should be flexible and easily extended at 
the site. 

The system wilt have several logical operators* each 
with different responsibilities and privileges. 

• The set of logical operators may be mapped onto one 
or more physical operators. 

The hardware and software necessary to support the 
Input and output streams of a physical operator 
should be no different from that o f any other Job. 
If special hardware is required fo'* specific 
functions* such as a graphics terminal for 
performance displays* that requirement would be 
satisfied in the same way as a user job that must use 
such a terminal. 



The system should be capable of operating 
default mode without any physical operators. 



in 



A site in a network may be operated by a physical 
operator at a different site. This is not an initial 
release objective. 
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2.2 CLASSES OF OPERATORS 



Seven logical operators with five levels of privilege 
are defined for each site. With the exception of REMOTE#OP* 
which is an alias for the user logged in on the remote batch 
terminal* each logical operator may be logged in from only 
one origin at a time. Their responsibilities and privileges 
are as fo I I ows. 



2.2.1 CE#OP 



This is the customer engineer. He or she is 
responsible for the proper function of the system hardware. 
CE#OP has the highest level of privilege of the operators 
and is capable of command functions such as taking full 
control of a processor that is recognized as '"up" by the 
operating system. 



2.2.2 SE#OP 



This is the systems engineer. He or she is responsible 
for the proper function of the system software. SE#OP has 
the second highest level of privilege and is capable of 
command functions such as replacing system modules and 
modifying the contents of system tables while the system is 
running. 



2.2.3 SYSTEM^OP 



This is the main console operator. He or she is 
responsible for "driving" the system and monitoring its 
normal operation. SYSTEM#OP has the third highest level of 
privilege and is capable of command functions such as 
starting* stopping or cancelling jobs and generally 
modifying the systems operational parameters. 
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2.0 GENERAL SYSTEM DESCRIPTION 
2.3 IMPLEMENTATION STRATEGY 



2.2.4 MASS#OPt TAPE#OP, BATCH#OP 



These are the operators resoonsible for servicing user 
or operating system requests for attention to mass storage, 
magnetic tape? batch and telecommunications devices. They 
have the fourth highest level of privilege and are capable 
of command functions such as rendering a device offline or 
online and directing output spooling. 



2.2.5 REMOTE#OP 



This is the operator of the remote batch terminal 
associated with a job. He or she is responsible for 
servicing user or operating system requests for attention to 
components of the remote batcn configuration. REMOTE#OP has 
the lowest level of privilege of any operator and is only 
permitted command functions affecting the local status of 
the remote batch terminal. 
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2. 3 IMPL^MENTATigtJ..SIRATtS_Y 
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Each operators environment will be built by the SCL 
user profile. In general* the profile wiir validate the 
operator, declare an OCS queue, select events and allow 
interrupt procedures, attach the LNS segment containing the 
operators repertoire and update the alternate operator 
routing information. 

All other jobs m^ust have an OCS queue and select the 
OCS signal id during job initiation. These functions will 
be performed by the OCSfflNIT procedure. 

The decision to represent each physical operator as an 
independent job rather than as a task of the system job is 
based on the following advantages. 

. The standard sequence monitor and SCL interpreter 
code may be used to interface to the input and output 
streams. Therefore no special logic is required to 
handle the I/O interface to OCS and all modes of 
physical access to the system are automatically 
supported. Also, OCS code will be insensitive to 
changes in SCL. 

. The normal user and system repertoires will be 
available to operators, thus extending the operators* 
capability and eliminating the need for special 
operator commands which appoximate normal user 
functions. ^ 

. Each physical operator will have a unique LNS search 
list and local LNS segment. 

Signals do not require redistribution within the 

NCR/CDC PRIVATE REV 21 MAY 7S 
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2.0 GENERAL SYSTEM DESCRIPTION 
2.3 IMPLEMENTATION STRATEGY 
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2.0 GENERAL SYSTEM DESCRIPTION 
2.^ DAYFILE RECORDING 



system job to operator tasKs. 

• REMOTE#OP is a special representation of the remote 
batch user and is already a job by definition. 

By utilizing the OS facilities available to jobst 
less code is required to satisfy DCS requirements. 

It is Dianned to begin implementation with the Job 
Interface (tasK services code) and the Job Communication 
commands when the required Program Management facilities are 
available. The individual commands of the repertoires will 
be implemented gradually as the methods of achieving each 
function within the capaibi I iti es of OS are determined. 
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All messages to an DCS operator job will be written to 
the IOC#OUTPUT stream of the particular OCS operator job. 
Messages from an OCS operator job will be written to either 
the IOC#INPUT or IOC#ALTERNATE streams depending on the 
origin of the command. This function is the standard 
operation of the SCL interpreter. 

Messages to operators from other j obs- and operator 
input to these jobs will be written to the OCS#LOG stream of 
the job by OCS tasK services. 
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3.0 JOB. INTERFACE 

3.1 OC#CONVERSE 



3.0 JOB INTERFACE 



The job interface is accomplished via OCS control 
language requests. Each time operator input is received by 
an OCS operator job» a signal is sent to the appropriate Job 
with the signal id of OCS. This pre-selected signal is 
placed in the Jobs OCS queue for processing by the 
OC#RECEIVE request. 

When a job wishes to direct a message to an operator^ 
the OCS task service request sends a signal to the 
appropriate OCS operator job. An interrupt procedure will 
be activated in the OCS operator Job to process the 

message. 

If the operator with which a job wishes to converse is 
not logged in to the system, the information will be passed 
to the alternate for that particular operator. ConverselYf 
if messages are expected from a particular logical operator, 
they may be received from an alternate. The user or system 
component must consider this when using OCS for a function 
that is sensitive to the actions of a particular operator. 
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3.1 OC/ACQNVERSE 



The purpose of the OC#CONVERSE request is to send a 
message to an operator and solicit a reply. The request 
does not wait for the reply before returning control. 



OC#CONVERSE (text? operator, rep ly_ordina I , status) 

text: The text parameter specifies a string containing 
the text of the- message. 

operator: The operator parameter specifies a string 
containing the name of the logical operator to 
which the message is to be directed. If this 
parameter is omitted (indicated by a blank string) 
the message will be sent to SYSTEM#OP for a local 
job or to REMOTE#OP for a remote batch job. 

repi y_ordinal : The repi y_ordina I parameter specifies an 
integer variable into which the reply ordinal 
generated by OCS is to be placed. 

status! The status parameter specifies a variable into 
which the status record is to be placed.^ The 
status codes returned are described under "error 
conditions". 
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3.0 JOB INTERFACE 
3.2 OC#INFORM 
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3.0 JOB INTERFACE 
3.3 OC#RECEIVE 



3.2 OCilNFOEd 



The purpose of the OC#INFORM request is to send an 
information message to an operator. No reply is expected. 



OC^INFORM (text, operator, status) 

text: The text parameter specifies a string containing 
the text of the message. 

operatori The operator parameter specifies a string 
containing the name of the logical operator to 
which the message is to be directed. If this 
parameter is omitted (indicated by a blanK string) 
the message will be sent to SYSTEM#OP for a local 
job or to REMOTE#OP for a remote batch Job. 

status! The status parameter specifies a variable into 
which the status record is to be placed. The 
status codes returned are described under "error 
conditions". 
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3.3 0C# RECEIVE 



The purpose of the 0C#RECEIVE request is to accept the 
text of operator input. 



OC#RECEIVE (wait, operator, 
countf status) 



repi y_ordinal , 



buffer. 



wait: The wait parameter specifies a boolean variable. 
If the value of. the variable is true, control will 
not be returned until a message meeting the 
criteria of the other parameters is received. If 
the value of the variable is false, control will 
be returned immediately with a queued message or 
an appropriate status. 

operator: The operator parameter specifies a string 
containing the name of the logical operator from 
which the message must be received. If this 
parameter is omitted (indicated by a blank 
string), input from any operator will satisfy the 
request. 

repI y_ordinal : The rep I y_ordina 1 parameter specifies an 
integer containing the reply ordinal returned by 
the OC#CONVERSE request for which a reply must be 
received. If this parameter is omitted (indicated 
by a zero) , any input will satisfy the request. 

buffer: The buffer parameter specifies a string 
variable into which the text of the message is to 
be placed. 

count: The count parameter specifies an integer 
variable into which the number of outstanding 
messages not yet received by the Job is to be 
Placed. 

status: The status parameter specifies a variable into 
which the status record is to be placed. The 
status codes returned are described under "error 
conditions". 



NOTE: The conditional relationship between the ooerator and 
the rep I y_ordinal parameters is "logical and". That 
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3,0 JOB INTERFACE 
3.^ OC#SELECT 



is» if both are specified* only a message meeting bo 
criteria will be received. 
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3.^ OC<^SELECT 



The puroose of the OC#SELECT request is to associate an 
event control blocK with the arrival of operator input. 
This event control block is user defined and is secondary to 
the one internally associated with the task service OCS 
queue of signals. After the OC#SELECT request is issued the 
OCS interrupt procedure within the job will issue a 
PM#CAUSE_EVENT on the specified event control block. 

This request is intended for optional use to reduce the 
number of unproductive executions of OC#RECEIVE in a program 
that must allow for unsolicited operator input. Refer to 
the Program Management GDS for a description of the eveni 
control block and its uses. 



OC#SELECT (event, status) 

event I The event parameter specifies a record 
containing an event control block to be associated 
with the arrival of operator messages. 

statusi The status parameter specifies a variable into 
which the status record is to be placed. The 
status codes returned are described under "error 
conditions". 
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^.0 SYSTEM INTERFACE 

^.1 REQUESTS TO TASK SERVICES 



k,Q 



RFACE 



The system interface to OCS may be of four types^ 
First, the requests described in "3.0 Job Interface" may be 
issued by a system job or by task services on behalf of a 
job. Second, an operator command will execute an SCL 
command procedure that may issue one or more task service 
requests on behalf of the OCS job itself, Thirdt a command 
procedure may invoke a new task or subtask within the OCS 
job. Fourth, a command procedure may send one or more 
signals to other jobs. 



1 
2 
3 

5 
6 
7 
8 
9 
10 
11 
12 
13 
1^ 
15 
16 
17 
18 
19 
20 
21 
22 
23 
Zk 
25 
26 
27 
28 
29 
30 
31 
32 
33 
Zk 
35 
36 
37 
38 
39 
t»0 
f*i 
t*Z 
kZ 
t*k 
t»5 
^6 
tf7 
i»8 



^.1 REQUESTS TO T ASK SE RVICES 



In addition to the normal user and system repertoires, 
each logical operator has its own commands. Most of these 
commands result in a request being issued to task services 
for the required function to be performed. For example, the 
operator command to bring a device online would result in 
task service requests to LNS and the I/O system to construct 
the required tables and open the device. 



k.Z 



Some command functions may be best achieved by the 
execution of an asynchronous task or subtask. In this case 
the command procedure will issue a PM#EXECUTE request to 
invoke the required program. Examples of this type ,of 
command would be to begin collecting measurement data or to 
run an on-line diagnostic. 



^.3 ^GNAJLS ro JgBS 



Certain operator commands may require the interruption 
of jobs in the system. This is accomplished by the command 
procedure issuing a request to send a signal to the job. 
Although the command procedure is similar to a direct 
request in that a PM#SEND_SIGN AL request is issued, the 
receiving job must have selected the signal. 

Two examples of this type of command are the commands 
to cancel a job, (where the sequence monitor of the job has 
selected the cancel signal) and the command to stop or 
restart a listing currently being printed. In the second 
case, several signals of this type are selected by File 
Router. 
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5.0 OPERATOR INThRFACt 

5.1 ALTERNATE OPERATORS 



5.0 OP ERATOR INTERFACE 



The operator interface is achieved by interacting with 
an instance of execution of the System Command Language 
interpreter (SCL) with the added capability of receiving 
unsolicited output to satisfy the requirements of 
system-to-operator communication. An operator is made known 
to the system via the normal LOGIN functions and is 
established as an independent job. 

The operator interface is expected to evolve in 
response to both system and operational requirements. As 
needs arise for various system components to interact with 
operators* the appropriate commands will be added to the 
repertoire. A I so ♦ operating requirements may require 
extensions to the operating system in the form of requests 
or sensitivity to signals. 

In addition to the commands described in this section* 
the full capabilities of SCL including macros* enter files 
and control constructs are available to all operators* 
Refer to the System Command Language CDS for further 
information* 
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5.1 ALTERNATE QP£RATO_R$ 



In the event that a job requests communication with a 
logical operator that is not currently logged in to the 
system* a system of "buck passing" is required. The 
alternate for a logical operator must always have the level 
of privilege required to respond to or to act on the 
request. This hierarchy of alternates is dynamic and is 
recorded in global LNS by the system profile at autoload. A 
recommended system of alternates is described below. 



OPERATOR 

REMOTE#OP 

BATCH#OP 

TAPE#OP 

MASS#OP 

SYSTEM#OP 

SE#OP 

CE#OP 



ALTERNATE 

BATCH#OP 

TAPE#OP 

MASS#OP 

SYSTEM#OP 

SE#OP 

Error to SYSTEM#OP 

Error to SYSTEM#OP 



If a request was redirected to an alternate operator or 
no alternate could be found* an appropriate status is 
returned by the OC#CONVERSE and the OC#INFORM requests. 

This rerouting may be accomplished by OCS task service 
request processors consulting a list of logged in operators 
in global or shared LNS. 
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5.0 OPERATOR INTERFACE 
5.2 MESSAGE FORMATS 
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5.0 OPERATOR INTERFACE 
5.3 COMMAND REPERTOIRES 



Messages to operators have the following general 
format. 

t<reDly ordina I > 1. < J ob id>/<text>. 

For example, the output from an OC#CONVERSE request 
would appear as follows. 

3.TAPEJ0B/M0UNT TAPE 123/f56. 

The output from an OC#INFORM reauest would- omit the 
reply ordinal and appear as follows. 

LONGJOB/THIS JOB WILL RUN FOR 6 HOURS. 
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5.3 OfltlMANO REPORT OI.S£S 



The command repertoires of each level of privilege are 
contained in LNS segments that are attached when an operator 
is logged in. Each operator has available the repertoire of 
its own level of privilege as well as the repertoires of all 
lower levels. For example, SYSTEM#OP has available 

SYSTEM#OP, MASS^OP, TAPE#OP, BATCH#OP, REMOTE#OP and job 
communication repertoires. However, SYSTEM#OP may not use 
the commands available only to SE#OP and CE#OP. 
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5.0 OPERATOR INTERFACE 

5,3.1 JOB COMMUNICATION COMMANDS 
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5.0 OPERATOR INTERFACE 
5.3.1.2 Inform or Interrupt 



5.3.1 JOB COMMUNICATION COMMANDS 



Job communication commands are used to interact with 
the DCS tasK service requests OC#CONVERSE, 03#INF0RM and 
OC#R£CEIVE. These commands are similar to those described 
under "'♦.3 Signals to System Jobs" except that a standard 
signal with input text is sent to a possibly non-system job 
and processed in that fob by OCS task services. The job 
communication commands are available to all operators. 



5.3.1.1 BSfil^ 



The purpose of the reply command is to respond to a 
message issued by an OC#CONVERSE request. The syntax is as 
f o I lows. 



REPLY I 



R to= <expr> 
<ref name>l 



[ text= 



<expr>l 



Istatus= 



toi The to parameter specifies the reoly ordinal 
associated with the message receiving the 
response. 

texts The text parameter specifies a string containing 

the text of the reply. Omission of the text 

parameter will cause the reply to be a blank 
string. 

status I s8 The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



Examples: 

reply to=3, text= 'go ' 
r 3 
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5. 3. 1. 2 I nform or In terrupt 



The purpose of the inform command is to send 
unsolicited input to a job. The syntax is as follows. 



INFORM I INTERRUPT I I Cto= <ref name>l Ctext= <expr>] 
[status= <ref name>] 

to: The to parameter specifies the name of the job to 
which the message is to be sent. Omission of this 
parameter will cause the message to be broadcast 
to al I jobs . 

text: The text parameter specifies a string containing 
the text of the message to be sent. Omission of 
the text parameter will cause the text to be a 
blank string. 

status I s: The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



Examp lest 

interrupt msgswitch 
8.MSGSWITCH/ENTER INSTRUCTIONS. 

i text='system going down in 5 min. 
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5,0 OPERATOR INTERFACE 
5.3.2 CE#OP REPERTOIRE 



5.3.1.3 Displa y 



The display command may be used by the operator to 
disolay outstanding messages awaiting replies. Refer to the 
user repertoire for further details. The syntax in this 
context is as follows. 



DISPLAY name= <ref name> Cstatus= <ref name>l 

name I n: This parameter specifies the name of the list 
of messages to be displayed. 

status I si The staitus parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



Example: 

display batch#op->messages 

13.13.13 7. ROUTER/MOUNT FORM ABC ON SYSPRT^. 

13.20.01 11. ROUTER/END OF FORMS ON SYSPRT2. 

Notei the leftmost set of three numbers is the time of day 
(hh.mm.ss) that the message was issued. The next 

number is the reply ordinal. 
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5.3.2 CE#OP REPERTOIRE 



5.3.2.1 Statu? 



The purpose of the status command is to display the 
status of an entity in the system. The command syntax is as 
fol lows. 



STATUS I S name= <ref name> tstatus= <ref name>l 

name I nt This parameter specifies the name of the 
entity for which a formatted status report is to 
be displayed. The LNS type of the name indicates 
the procedure to be used for data collection and 
formatting. If there is no predetermined fornvat 
for a oarticular type the command degenerates to a 
DISPLAY operation. 

status I SI The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



ExampI el 

s tapelOO 

VOLUME 1Z3456 ON TAPEIOO. 

ASSIGNED TO TAPE JOB. 

17 RECOVERED READ ERRORS. 
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5.0 OPERATOR INTERFACE 
5.3. 2. 3 Unseize 



5.3.2.2 i£iz£ 



The purpose of the seize command is to take oyer 
complete control of a hardware resource. In certain cases 
tnis may taKe a considerable amount of time. Thereforet the 
command may be either synchronous or asynchronous depending 
in the resource being seized. The command syntax is as 
follows. 



SEIZE I SZ resource= <rGf name> [status= <ref name>] 

resource I rJ This parameter specifies the resource to 
be seized. 



status I St The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SOL error 
handler to be invoKed upon the occu?*rence of an 
error condition. 



Examples! 

seize resource=cpul 
CONFIGMGR/CPUl AVAILABLE. 

SZ disk20Q 

SEIZE ON OISK200 PENDING. 



CONFIGMGR/DISK200 AVAILABLE. 
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5.3.2.3 Mr^sejze 



The purpose of the unseize command is to return the use 
of a seized resource to the system. The command syntax is 
as foil ows. 



UNSEIZE I UZ resource= <ref name> Cstatus= <ref name>1 

resource I rx This parameter specifies the resource to 
be returned to the system. 

status I ss The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



Examples 

UZ core2 
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5.0 OPERATOR INTERFACE 
5.3.3 S£#OP REPERTOIRE 
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5.0 OPERATOR INTERFACE 
5.3.3.2 Memory 



5.3.3 SE#OP REPERTOIRE 



5.3.3.1 S tatus 



The purpose of the status command is to display the 
status of an entity in the system. The command syntax is as 
fo ! lows. 



STATUS \ S name= <ref name> [status= <ref name>l 

name I ni This parameter specifies the name of the 
entity for which a formatted status report is to 
be displayed. The LNS type of the name indicates 
the procedure to be used for data collection and 
formatting. If there is no predetermined format 
for a particular type the command degenerates to a 
"list data" operation. 

status I s: The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



Example: 

s tapelOO 

VOLUME 123^56 ON TAPEIOO. 

ASSIGNED TO TAPEJOB. 

17 RECOVERED READ ERRORS. 
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5. 3. 3. 2 Memor y 



The purpose of the memory command is to display or 
alter either real or virtual memory. The command syntax is 
as fol I ows. 



MEMORY I M real I virtual= <expr> Cwords= <expr>l [data= 
(<expr>[ t<expr>] .. . )3 Cstatus= <ref name>l 

real I r I virtual 1. vt This parameter specifies the 
address to begin memory access* The keyword used 
indicates whether the address is real or virtual* 
Omission of the keyword causes a default of 
virtual to be assumed* The virtua I address refers 
to the address space of the SE#OP operator job and 
may include an image of System Monitor segments* 

words I wJ This parameter specif es the number of words 
to access* Omission of this parameter will cause 
a default of one (1) word to be assumed* 

data I d: This parameter specifies the data to be 
entered into the memory described* Omission of 
this parameter will cause the memory to be 
displayed in hexadecimal and ascii 
representation. 

status I sx The status parameter specif ies a variable 
into which the status is to be returned* Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition* 



ExampI esJ 

memory loc(tapelQO) 

SSSS AAAAAAAAAAAA 5tf ^150 ^531303020 TAPEIOO 
(Where SSSS is the segment and AAAAAAAAAAAA is the 
address* ) 



m r=1000(16) ,2,(5rOe(16)) 

0000 ooooooooioao 0000000000000005 

0000 000000001008 OOOQOOOOOOOOOOOE 
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5.0 OPERATOR INTERFACE 
5.3,3,3 Patch 
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5.0 OPERATOR INTERFACE 
5.3.^ SYSTEM#OP REPERTOIRE 



5.3.3.3 Patgh 



The purpose of the patch command is to dynamically 
replace one or more procedures in the system. The command 
syntax is as follows. 



PATCH I P proc= ( <ident>[,< ident> ] .. . ) [job= 

(<ref name>[,<ref name>1...)J tstatus= 

<ref name>1 

procedure I procedures I proc I procs I pi This 
parameter specifies the name of the procedure (s) 
to be replaced. The new version of the procedure 
must reside in a library or object file Known to 
the SE#OP operator Job. 

job \ jobs J ji This parameter specifies the Job(s) to 
be affected by the change. Omission of this 
parameter will cause all jobs to be affected. 

status I sJ The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



Example x 

p procs= ( tmrmOai*Q» tmrmOa^l) 9 j ob = test j ob 
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5.3.^ SYSTEM#OP REPERTOIRE 



5.3.^.1 Status 



The purpose of the status command is to display the 
status of an entity in the system. The command syntax is as 
fo I lows. 



STATUS I S name= <ref name> tstatus= <ref name>l 

name I ni This parameter specifies the name of the 
entity for which a formatted status report is to 
be displayed. The LNS type of the name indicates 
the procedure to be used for data collection and 
formatting. If there is no predetermined format 
for a particular type the command degenerates to -a 
"list data" operation. 

status I s: The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



Example I 

s tapelOO 

VOLUME 123it56 ON TAPEIOO. 

ASSIGNED TO TAPEJOB. 

17 RECOVERED READ ERRORS. 
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5.0 OPERATOR INTERFACE 
S.Z.k.Z Set 
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5.0 OPERATOR INTERFACE 
5.3. if. 2 Set 



5.3.4.2 ^gt 



The purpose of the set command is to set various system 
operational values. The command syntax is as follows. 

SET [time= <expr>3 tdate= <expr>] tt I = <expr>l Crl = 
<expr>] [bl= <expr>] tbias= 
(bl ilrC ,bl ilrCblilrl 3)1 [status= <ref name>1 

time I tx This parameter specifies a string containing 
the time to which the clock is to be set. It must 
be entered in the format "hh mm ss". 

date I dt This parameter specifies a string containing 
the date to which the clock is to be set. It must 
be entered in the format "yy mm dd". 

termlimit I tit This parameter specifies the maximum 
number of interactive jobs that may be logged in 
at one time. 

remotelimit I r\i This parameter specifies the maximum 
number of remote batch terminals that may be 
logged in at one time. 

batchlimit I bi: This parameter specifies the maximum 
number of batch )obs (local op remote) that may be 
in execution at one time. 

bias I bJ This parameter specifies the overall biasing 
of processor dispatching priority among batch (bl» 
interactive (i ) and remote batch (r) Jobs. The 
classes are entered in order of priority from left 
to right. 

status I si The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



NOTE: The selection af parameters for this command is 
arbitrary for illustration. They will become defined 
as OS design progresses. 
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Example* 

set t='10 10 10-,date=-75/05/25',bl=6 
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5.0 OPERATOR INTERFACE 
S,3»k»Z Shutdown 
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5.0 OPERATOR INTERFACE 
5.3.^.^ Hold 



5.3.^.3 S.!lUlJt2viD 



The purpose of the shutdown command is to close down a 
site in an orderly manner. The command syntax is as 
f ol I ows. 



SHUTDOWN I SD CnowJ Cstatus= <ref name>J 

nowi This parametePf if quoted^ causes the system to 
close immediately without warm start capability. 
All activities are canceled. Omission of this 
parameter will result in a soft shutdown with all 
activities put into "hold" status with a warm 
start possible. This parameter should only be 
used when an urgent shutdown is required. 

status I sJ The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



Example! 
sd 

note: a start system command will negate a soft shutdown 
that is in progress. 



1 
2 
3 

5 
6 
7 
8 
9 
10 
11 
12 
13 
Ik 
15 
16 
17 
18 
19 
20 
21 
22 
23 
Zk 
25 
26 
27 
28 
29 
30 
31 
32 
33 
Zk 
35 
36 
37 
38 
39 
t»0 
<tl 
k2 
t*Z 
kk 
k5 
kb 
M7 
^8 



5.3.^.4 Hold 



The purpose of the hold command is to suspend an 
activity at the next logical step. The point of suspension 
is such that a new autoload with a warm start would not 
affect the activity. For example, a Job in the input queue 
would stay there while an executing job would complete the 
current job step. Refer to "5.^ Command Summary" for a 
description of the activities that may be referenced by this 
command at this level of privilege. The command syntax is 
as foil ows . 



HOLD I 



H name= (<ref name>[,<ref name>1. ..) I SYSTEM 
Cstatus= <ref name>3 



names I name I nl This parameter specif ies the activity 
or activities to be held. The special name 
"SYSTEM" represents the set of all activities that 
may be affected by this command. 

status I si The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



Example? 

h ( inputq» I ongj ob»sysprt3) 
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5,0 OPERATOR INTERFACE 
5.3,if.5 StOD 
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5.0 OPERATOR INTERFACE 
5.3.^.6 Start 



5, 3. if. 5 ato£ 



The purpose of the stop command is to suspend an 
activity immediately. Refer to '•5.^ Command Summary" for a 
description of the activities that may be referenced by this 
command at this level of privilege. The command syntax is 
as foil ows. 



STOP I 



SP name= (<ref name>t,<ref name>1 • . •) ISYSTEM 
[status= <ref name>! 



names I name I nl This parameter specifies the name of 
the activity to be stopped. The special name 
"SYSTEM" represents the set of all activities that 
may be affected by this command. 

status I si The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoKed upon the occurrence of an 
error condition. 



Example: 

sp ( sysrdri ,remote_q) 
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5.3,«*.6 Start 



The purpose of the start command is to restart an 

activity previously suspended by a hold or a stop command or 

to start using a new "onsystem" (see ONSYSTEM commandl 

device. The command syntax is as follows. 



START I ST name= (<ref name>l»<ref name>l •..) I SYSTEM 
[status= <ref name>l 

names I name I ni This parameter specifies the name of 
the activity to be started. The special name 
"SYSTEM" represents the set of all activities that 
may be affected by this command. 

status I St The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



Example: 

start sysrdr2 
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5.0 OPERATOR INTERFACE 
5.3.f*.7 Reset 
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5.0 OPERATOR INTERFACE 
5.3.^.8 Cancel 



5.3.^.7 Reset 



The purpose of the reset command is to reset an 
activity to its beginning. For example, a listing would 
reset to the first page and an executing job would return to 
the login point. Refer to "5.^ Command Summary" for a 
description of the activities that may be referenced by this 
command at this level of privilege. The command syntax is 
as fol lows. 



RESET I RS name= (-^ref name>C ♦<ref name>]...) [status= 
<ref name] 

names I name S n: This parameter specifies the name of 
the activity to be reset. 

status I St The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



Example* 

rs snafu) Ob 
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5. 3.^. 8 Cancel 



The purpose of the cancel command is to immediately 
stop an activity and purge it from the system. Refer to 
"5.^ Command Summary" for a description of the activities 
that may be referenced by this command at this level of 
privilege. The command syntax is as follows. 



CANCEL I C name= (<ref name>[ ,<ref name>]...> tstatus= 
<ref name>l 

names I name I ni This parameter specifies the name of 
the activity to be canceled. 

status I SI The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



ExampI e: 

c names=(job^,sy srdr 3) 
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5.0 OPERATOR INTERFACE 

5.3.5 MASS#OP, TAPE#OP AND BATCH#OP REPERTOIRES 



5.3.^.9 Atr?r 



The DUTDose of the alter command is to change the 
limits or operational parameters of a job. The command 
syntax is as follows. 



ALTER J A job= <ident> Cpriority= <expr>3 tresources= 

(<expr>[ ,<expr>l •• .) ] Itimelimit= <expr>l 

[origin= <expr>1 [destinations <ref name>3 
[status= <ref name>3 

Job J ]t This parameter specifies the job whose 
parameters are to be altered. 

priority I pJ This parameter specifies the new priority 
of the job. 

resources I rx This parameter specifies the new 
resources required by the Job. 

timelimit I time I ti This oarameter specifies the new 
time limit for the job. 

origin I orig 1 ol This parameter alters the recorded 
origin of the job. 

destination I dest I di This parameter alters the 
ultimate disposition of the job's output. 

status I s: The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



NOTEl The selection of parameters for this command are 
arbitrary for illustration. They will become defined 
as OS design progresses. 



Examples 

alter test job, priority=17 »timel imit=60 
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5.3.5 MASS#OP, TAPE#OP AND 8ATCH#0P REPERTOIRES 



5.3.5.1 Statu s 



The purpose of the status command is to display the 
status of an entity in the system. The command syntax is as 
fo I I ows. -^ 



STATUS I S name= <ref name> [status= <ref name>1 

name \ n: This parameter specifies the name of the 
entity for which a formatted status report is to 
be displayed. The LNS type of the name indicates 
the procedure to be used for data collection and 
formatting. If there is no predetermined format 
for a particular type the command degenerates to a 
"list data" operation. 

status I si The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



Example: 

s tapelOO 

VOLUME 123^56 ON TAPEIOO. 

ASSIGNED TO TAPEJOB. 

17 RECOVERED READ ERRORS. 
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5,0 OPERATOR INTERFACE 
5,3.5.2 Hold 
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5.0 OPERATOR INTERFACE 
5.3,5.3 Stop 



5. 3.5. 2 Noil 



The purpose of the hold command is to suspend an 
activity at the next logical step. The point of suspension 
is such that a new autoload with a warm start would not 
affect the activity. Refer to "5.^ Command Summary" for a 
description of the activities that may be referenced by this 
command at this level of privilege. The command syntax is 
as foil ows. 



HOLO I H name= (<ref name>[»<ref name>l...) 
<ref name>l 



Cstatus= 



names I name I n 8' This parameter specifies the activity 
or activities to be held. 

status I si The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



Ex amp I e: 

h (inputqf I ongj ob»sysprt3) 
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5.3.5.3 Stop 



The purpose of the stop command is to suspend an 
activity immediately. Refer to "5.^ Command Summary" for a 
description of the activities that may be referenced by this 
command at this level of privilege. The command syntax is 
as f ol lows. 



STOP I SP name= (<ref name>Ct<ref name>l. 
<ref name>l 



[status= 



names I name I nt This parameter specifies the name of 
the activity to be stopped. 

status I St The staftus parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the S.CL error 
handler to be invoked upon the occurrence of an 
error condition. 



Example! 

sp (sysrdrl»remote_q) 
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5.0 OPERATOR INTERFACE 
5.3.5.^ Start 
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5.0 OPERATOR INTERFACE 
5.3.5.5 Reset 



5.3.5.^ ?t^rt 



The Durpose of the start command is to restart an 
activity previously suspended by a hold or a stoo command or 
to start using a new "onsystem" device. The comnand syntax 
is as fol lows. 



START I ST n3me= (<ref name>[ »<ref name>]...l [status= 
<rei name>] 

names t name I nt This parameter specifies the name of 
the activity to be started. 

status I St The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoKed uoon the occurrence of an 
error condition. 



ExampI e: 

start sysrdr2 
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5.3.5.5 Reset 



The purpose of the reset command is to reset an 
activity to its beginning. Refer to "5.'+ Command Summary" 
for a description of the activities that may be referenced 
by this command at this level of privilege. The command 
syntax is as follows. 



RESET I RS name= (<ref name>[,<ref name>3...) Cstatus= 
<ref name]. 

names I name I ns This parameter specifies the name of 
the activity to be reset. 

status I s« The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of' an 
error condi tion. 



ExampI e! 

rs snafujob 
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5«3.5.6 Cancel 
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5.0 OPERATOR INTERFACE 
5.3.5.7 Alter 



5. 3.5.6 Cance l 



The purpose of the cancel command is to immediately 
stop an activity and purge it from the system. Refer to 
"5.^ Command Summary" for a description of the activities 
that may be referenced by this command at this level of 
privilege. The command syntax is as follows. 



CANCEL I C name= (<ref name>[t<ref name>3...) 
<ref name>1 



[status= 



names I name I n« This parameter specifies the name 
the activity to be canceled. 



of 



status I ss The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



Examples 

c names=( job^»sysrdr3) 
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5.3.5.7 Allsr 



The purpose of the alter command is to change the 
limits or operational parameters of a Job. Refer to "S.'f 
Command Summary" for a description of the activities that 
may be referenced by this command at this level of 
privilege. The command syntax is as follows. 



ALTER I A job= <ident> Cpriority= <expr>l Clinelimit= 
<expr>3 Cform= <expr>3 Cdest= <ref name>] 
[status= <expr>) 

job I jt This parameter specifies the job whose 
parameters are to be altered. 

priority I pi This parameter specifies the new priority 
of the job. 

line limit I lines I It This parameter soecifies the' 
maximum number of lines that the outpjt listing 
may contain. 

destination I dest I d« This parameter specifies a new 
ultimate destination for, the job's output. At 
this level It may be necessary for the output to 
be moved to a different queue. 

form I ft This parameter specifies the form on which 
the output is to be printed. 

status 1 st The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



NOTEt The selection of parameters for this command are 
arbitrary for Illustration. They will become defined 
as OS design progresses. 



Examples 

alter test j obf priority=17, f orm= 'a/p cheques' 
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5,0 OPERATOR INTERFACE 
5,3.5.8 Onsystem 
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5.0 OPERATOR INTERFACE 
5,3,5,9 Offsystem 



5.3.5.8 On§.YSt?m 



The purpose of the onsystem command is to make 
available one or more devices to the System Access Manager 
or File Router. The command syntax is as follows* 



ONSYSTEM I NS devlce= (<ref name>C»<ref name>l«..) 
queue= (<ref name>C t<ref name>l.».> [status= 
<ref name>l 

devices I device I dev I dt This parameter specifies 
the name(s) of the device(s) to be made available 
to the system. 

queues I queue I qx This parameter specifies the 
name(s) of the queue (s) to be associated with the 
device (s) . 

status J st The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



NOTEl Several queues may be assocated with one or more 
output devices but only one queue may be associated 
with one or more input devices. 



Example* 

onsystem dev=sysrdr3,q=inputq 

ns {sysrdr^,aslut200) » remote_q 

ns (sysprtl* tape 10 0) »(out ql»outq2) 
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5.3.5.9 Of fsvstem 



The purpose of the offsystem command is to release one 
or more devices from system use by System Access Manager or 
File Router. An "offsystem" device is still online but is 
available to other jobs. The command syntax is as follows. 



OFFSYSTEM 1 FS device= (<ref name>t,<ref name>3...) 
tstatus= <ref name> 3 

devices I device I dev I d: This parameter specifies 
the nameCs) of the device(s) to be released. 

status I s« The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



ExampI el 

fs (tapelOO ,aslut200,sysprtl) 
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5.0 OPERATOR INTERFACE 
5.3.5,10 Backspace 
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5.0 OPERATOR INTERFACE 
5.3.5.11 ForesDace 



5.3.5.10 Backspac e 



The purpose of the backspace command is to back up an 
output listing a number of pages. The command syntax is as 
fol l^ows. 



BACKSPACE I B device= <ref name> lpages= 
tstatus= <ref name>J 



<expr>l 



device I dev I dJ This parameter specifies the name of 
the output device to be backspaced. 

pages I pt This parameter specifies the number of pages 
the listing is to be backspaced. Omission of this 
parameter wilt cause a default of one (II to be 
assumed. 

status \ SI The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occLtf*rence of an 
error condition. 



Ex amp I el 

backspace device=sysprt*>»pag^es=6 
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5.3.5.11 FprgspaCg 



The purpose of the forespace command is to forward 
space an output listing a number of pages. The command 
syntax is as follows. 



FORESPACE I F device= <ref name> Cpages= <expr>l 
tstatus= <ref name>l 

device I dev I di This parameter specifies the name of 
the output device to be forward spaced. 

pages I pi This parameter specifies the number of pages 
to forward space. Omission of this parameter will 
cause a default of one (1) to be assumed. 

status I sJ The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



Example: 

f sysprt2 
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5.0 OPERATOR INTERFACE 
5.3,5.12 Page 
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5.0 OPERATOR INTERFACE 
5.3.5.13 Onl ine 



CHP120'f 
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5.3.5.12 Page 



The purpose of the page command is to print a specific 
number of pages of an output I isting. The command syntax is 
as f of lows. 



PAGE I PG device= <ref name> [pages= <expr>3 [status= 
<ref name>l 

device 1 dev t d: This parameter specifies the name of 
the output device to be paged. 

pages I p: This parameter specifies the number of pages 
to cycle. Omission of this parameter will cause a 
default of one (1) to be assumed. 

status I St The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



ExampI et 

page sysprt2,4 
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5.3.5.13 Online 

The purpose of the online command is to add one or more 
devices to the configuration. The device descriptor(s) must 
have been previously declared. The command syntax is as 
fo I I ows. 



ONLINE I NL device= (<ref name>t»<ref name>]...) 
[status= <ref name>3 

devices I device I dev I dt This parameter specifies 
the name of the device(s) to be added. 

status I si The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



Example: 

online disk250 
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5.0 OPERATOR INTERFACE 
5.3.5.14 Offline 
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5.0 OPERATOR INTERFACE 
5.3.6 REMOTE#OP REPERTOIRE 



5.3.5.14 Offline 



The purpose of the offline command is to delete one or 
more devices from the configuration. The command syntax is 
as f ol lows. 



OFFLINE I FL device= (<ref name>[f<ref name>l...) 
[status= <ref name>3 

devices I device I dev I di This parameter specifies 
the name of the device(s) to be deleted. 

status 1 si The status parameter specifies a variable 
into which the status is t o be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



Example! 

fl (tapel00,sysrdrl»tty50 ) 
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5.3.6 REMOTE#OP REPERTOIRE 



5.3.6.1 Status 



The purpose of the status command is to display the 
status of an entity in the system. The command syntax is as 
fol I ows. 

STATUS I S name= <ref name> [status= <ref name>l 

name I ni This parameter specifies the name of the 
entity for which a formatted status report is to 
be displayed. The LNS type of the name Indicates 
the procedure to be used for data collection and 
formatting. If there is no predetermined format 
for a particular type the command degenerates to a 
"list data" operation. 

status I s« The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



ExampI ei 

s remprt4 

J0B7 PRINTING ON REMPRT4 
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5.0 OPERATOR INTERFACE 
5.3.6.2 Hold 
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5.0 OPERATOR INTERFACE 
5.3.6.3 Stop 



5.3.6.2 Hold 



The Durpose of the hold command is to suspend an 
activity at the next logical step. The point of suspension 
is such that a new autoload with a warm start would not 
affect the activity. Refer to "5.^ Command Summary" for a 
description of the acti\Mties that may be referenced by this 
command at this level of privilege. The command syntax is 
as fol lows. 



HOLD I H name= (<ref name>C»<ref name>!««.) 
<ref name>1 



Cstatus= 



names I name I ns This parameter specifies the activity 
or activities to be held. 

status I si The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



ExampI el 

h ( long j ob»remprt3) 
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5.3.6.3 Stop 



The purpose of the stop command is to suspend an 
activity immediately. Refer to "5.^ Command Summary" for a 
description of the activities that may be referenced by this 
command at this level of privilege. The command syntax is 
as fol I ows. 



STOP I SP name= (<ref name>C,<ref name>l...) [status= 
<ref name>1 

names I name I ni This parameter specifies the name of 
the activity to be stopped. 

status I si The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL errpr 
handler to be invoked upon the occurrence of an 
error condi tion. 



Examplei 

sp (remrdrl,remote_q) 
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5,0 OPERATOR INTERFACE 
5,3,6.^ Start 
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5.0 OPERATOR INTERFACE 
5.3. 6,5 Reset 



5.3.6.4 St^rt 



The purpose of the start command is to restart an 
activity previously suspended by a hold or a stop command or 
to start using a new "onsystem" device. The command syntax 
is as f ol I ows. 



START J ST name= (<ref name>[f<ref name>1..*) Cstatus= 
<ref name>l 

names J name I n: This parameter specifies the name of 
the activity to be started. 

status J ss The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



ExampI e: 

start remrdr2 
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5.3.6.5 R^^Qt 



The purpose of the reset command is to reset an 
activity to its beginning. Refer to "5.4 Command Summary" 
for a description of the activities that may be referenced 
by this command at this level of privilege. The command 
syntax is as follows. 



RESET I RS name= ( <re f name>t,<ref name>3.«.} tstatus= 
<ref name]- 

names I name I nt This parameter specifies the name of 
the activity to be reset. 

status I sJ The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of , an 
error condition. 



ExampI et 

rs snaf ul ist 
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5.3.6.6 Cancel 
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5.0 OPERATOR INTERFACE 
5.3.6.7 Alter 



5.3.6.6 aanc^ 



The purpose of the cancel command is to immediately 
stop an activity and purge it from the system. Refer to 
"5.^ Command Summary" for a description of the activities 
that may be referenced by this command at this level of 
privilege. The command syntax is as follows. 



CANCEL I C name= (<ref name>t»<ref name>3...) 
<ref name>3 



tstatus= 



names I name I nt This parameter specifies the name of 
the activity to be canceled. 

status I St The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



Example: 

c names=( jobtt»sy srdr3) 
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5.3.6.7 Alter 



The purpose of the alter command is to change the 
limits or operational parameters of a job. Refer to "5»k 
Command Summary" for a description of the activities that 
may be referenced by this command at this level of 
privilege. The command syntax is as follows. 



ALTER I A j ob= <ident> Cpriority= <expr>l [linelimit= 
<expr>] [form= <expr>] Cdest= <ref name>] 
[status= <expr>l 

job I }: This parameter specifies the job whose 
parameters are to be altered. 

priority I px This parameter specifies the new priority 
of the Job. 

linelimit I lines 1 11 This parameter specifies the 
maximum number of lines that the output listing 
may contain. 

destination I dest I dt This parameter specifies a new 
ultimate destination for the job's output. At 
this level it may be necessary for the output to 
be moved to a different queue. 

form I fi This parameter specifies the form on which 
the output is to be printed. 

status I sx The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



NOTEl The selection of parameters for this command are 
arbitrary for illustration. They will become defined 
as OS design progresses. 



Examples 

alter test j ob,dest=' acctng* » f orm=" a/p cheques" 
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5.0 OPERATOR INTERFACE 
5.3.6.9 Forespace 



5.3.6.8 Backspace 



The purpose of the backspace command Is to back up an 
output listing a number at pages. The command syntax is as 

fol lOVfS. 



BACKSPACE J B device= <ref name> [page3= <expr>l 
[status= <ref name>3 

device 1 dev I d: This parameter specifies the name of 
the output device to be backspaced. 

pages I pi This parameter specifies the number of pages 

the listing is to be backspaced. Omission of this 

parameter will cause a default of one (1) to be 

assumed. 

status I si The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



Exampl el 

backspace device=rempr t4» pages=6 
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5.3.6.9 Forespac e 



The purpose of the forespace command is to forward 
space an output listing a number of pages. The command 
syntax is as follows. 



FORESPACE I F device= <ref name> [pages= <expr>3 
Cstatus= <ref name>l 

device 1 dev I di This parameter specifies the name of 
the output dev^ice to be forward spaced. 

pages I pi This parameter specifies the number of pages 
to forward spa^ce. Omission of this parameter will 
cause a default of one (1) to be assumed. 

status I si The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SOL error 
handler to be invoked upon the occurrence of an 
error condition. 



Examplel 

f remprt2 
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5.0 OPERATOR INTERFACE 
5.3.6.^11 Onl ine 



5.3.6.10 P age 



The purpose of the page command is to print a specific 
number of pages of an output listing. The command syntax is 
as fol lows. 



PAGE I PG device- <ref name> Cpages= <expr>} Cstatus= 
<ref name>l 

device I dev I dJ This parameter specifies the name of 
the output device to be paged. 

pages 1 pi This parameter specifies the number of pages 
to cycle. Omission of this parameter will cause a 
default of one (1) to be assumed. 

status I sJ The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



Example! 

page remprt2»2 
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5.3.6.11 Online 



The purpose of the online command is to add one or more 

devices to the remote conf iguation* The device 

descriptor (s) must have been previously declared. The 
command syntax is as follows. 



ONLINE I NL device= (<ref name>C ,<ref name>]...) 
[status= <ref name>] 

devices I device \ dev I di This parameter specifies 
the name of the device(s) to be added. 

status I si The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



ExampI el 

online remrdr2 
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5.0 OPERATOR INTERFACE 
5.^ COMMAND SUMMARY 



5.3.6.12 Off r in g 



The purpose of the offline command is to delete one or 
more devices from the remDte configuration. The command 
syntax is as f ol lows. 



OFFLINE I FL device= {<ref name>C t<ref name>3 .. • ) 
tstatus= <ref name>3 

devices \ device I dev I dt This parameter specifies 
the name of the device(s) to be deleted. 

status I ss The status parameter specifies a variable 
into which the status is to be returned. Omission 
of the status parameter will cause the SCL error 
handler to be invoked upon the occurrence of an 
error condition. 



Example: 

fl (remrdrlt tty50) 
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S.h COMMAND SUMM ARY 



The following table illustrates the availability of 
commands to different levels of operators and the activities 
that may be affected by them. The fallowing abbreviations 
are used in the table. 

ok no restrictions 

na not available 

--> included via lower level repertoire 

system entire system 

q input or output queue 

opq output queue 

ropq remote batch output queue 

job Job 

rjob remote origin job 

opqjob Job in output queue or function 

ropqjob job in remote batch output queue or function 

dev device 

sysdev "onsystem" device 

rdev remote batch terminal device 

rsysdev remote batch terminal "onsystem" device 

To use the tabid, locate the intersection of the 
command name and the logical operator Job name. The 
activities that may be referenced by the command when used 
by the particular logical operator are all those to the 
right of the intersection in the row for that command. If 
an arrow ( — >) is encountered* follow it. 



1 
2 
3 

5 
6 
7 
8 
9 
10 
11 
12 
13 
lif 
15 
16 
17 
18 
19 
20 
21 
22 
23 
2^ 
25 
26 
27 
28 
29 
30 
31 
32 
33 
3^ 
35 
36 
37 
38 
39 
^0 
^1 
t*Z 
kZ 

^5 
46 
k7 
48 
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5,0 OPERATOR INTERFACE 
5*k COMMAND SUMMARY 



CE#OP 

reply — > 

inform — > 

status --> 

seize ok 

unseize oK 

memory — > 

patch --> 

set — > 

shutdown — > 

hold — > 

stop — > 

start — > 

reset — •> 

cancel — > 

alter --> 



SE#OP 



-- > 
--> 

na 
na 
OK 
ok 
-- > 



5VSTEM#0P MASS#OP 
TAPE#OP 
BATCH #0P 



--> 
--> 



ok 
ok 
ok 



REt10TE#0P 

rjob 

r j Ob 

ropq 
r J Ob 
r dev 



na 


na 


na 


na 


na 


na 


na 


na 


na 


na 


na 


na 


ok 


na 


na 


system 


na 


na 


system 

q 

job 


opq 

opqjob 

sysdev 


ropqj ob 
rsysdev 


system 

q 

job 


opq 

opqjob 

dev 


ropqj ob 
rdev 


system 

q 

j ob 


opq 

opqjob 

dev 


ropqj ob 
rdev 


job 


opqjob 
sysdev 


ropqj ob 
rsysdev 


q 
j ob 


opq 

opqjob 

sysdev 


ropqj ob 
rsysdev 


j ob 


opqjob 


ropqj ob 
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li* 
15 
16 
17 
18 
19 
20 
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Zk 
25 
26 
27 
28 
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30 
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36 
37 
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39 
kQ 
tfl 
kZ 
k3 
kt* 
kS 
kb 
k7 
^8 
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5.0 OPERATOR INTERFACE 
5.^ COMMAND SUMMARY 



CE#OP 

onsystem — > 
of fsystem--> 
backspace — > 
forespace — > 
page — > 

online — > 
of f I ine — > 



SE#OP 

--> 
-- > 
--> 
— > 



SYSTEM#OP MASS#OP 
TAPE#OP 
BATCHfOP 



REMOTE#OP 



dev 


rdev 


dev 


rdev 


sysdev 


rsysdev 


sysdev 


rsysdev 


sysdev 


rsysdev 


dev 


rdev 


dev 


rdev 



1 

2 
3 

5 
6 
7 
8 
9 
1& 
11 
12 
13 
1^ 
15 
16 
17 
18 
19 
20 
21 
22 
23 
Zk 
25 
26 
27 
28 
29 
30 
31 
32 
33 
3^ 
35 
36 
37 
38 
39 
^0 
^1 
kZ 
kZ 
kk 
k5 
hb 
hi 
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OPERATOR COMMUNICATIONS 

6.0 ADDITION OF NEW COMMANDS 

-.. . — . . — J . . .^««..«,« 

6.0> DPITION O F N£W CQMMANQS 1 

• 2 

3 

5 
6 

" 7 
The addition of new commands to DCS is the same as for 8 
any other instance of SCL and is described in the Command 9 
Writers Guide* Consideration must be given to the various 10 
interactions involved tor some commands that affect other 11 
functionat areas ot the system. 12 

13 
Ik 
15 
16 
17 
18 
19 
20 
21 
22 
23 
Zk 
25 
26 
27 
28 
29 
30 
31 
32 
33 
Zk 
35 
36 
37 
38 
39 
kQ 
kl 
hZ 
kZ 
hk 
kS 
^6 
^7 
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7.0 OPERATING SYSTEM DE P ENDENCI ES 



The DCS system described is highly dependent on certain 
features and co-operative action being present in the 
operating system. These fall into two major categories. 

Firstt all OCS commands require that referenced 
parameters (queues^ j obSf devices^ etc.) may be located via 
LNS in the global segment or in the local segment of the 
reast privileged user of a particular command. This access 
may be achieved by the data being in LNS, a pointer or 
pointers to the data in LNS or the descriptor of a procedure 
that is capable of locating tne data residing in the proper 
LNS segment. Note that with the exception of the status 
commands write access is often required. 

Second, each area of the system must ensure that the 
set of orimitives required to complete an OCS command is 
made available. In many cases, a command may require 
complementary operations from several system areas* 

The OCS system implementation is a "top down" 
definition. An attempt has been made to describe an 
efficient and practical operating facility without immediate 
regard for the capabilities of the Operating System. 
Conversely, the system repertoire is "bottom up" and is an 
externa lizat ion of defined Operating System capabilities 
with simplification and combination added at the command 
level. 



Particular note 
command. This comm 
f lexibi li ty and may 
parameter is locate 
procedure is called t 
data type has no as 
named variable are 
conventions. An ex 
LNS data type is "pr 
procedure is invoke 
result of the above t 
be I isted in "sta 
maintained in global 



should be made of the "status" 
and procedure is designed for maximum 

function in three ways. The name 
d in LNS and a data type dependent 
o format the status display. If the 
sociated procedure, the contents of the 

listed according to standard SCL 
ception to this process occurs when the 
ocedure". In this case, the named 
d to produce the status report. The 
echnique is that an LNS descriptor may 
tus" form, a status report may be 
or operator LNS as an array of strings 



1 
2 
S 
«f 

5 
6 
T 
8 
9 

la 
11 

12 
13 

1^ 

15 
16 
17 
18 
19 
20 
21 
22 
23 
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25 
26 
27 
28 
29 
30 
31 
32 
33 
3k 
35 
36 
37 
38 
39 
^0 
^1 
t*Z 
kZ 
t*h 
k5 
kb 
k7 
^8 



or special status requests may. be issued to task services 
for access to Information not in LNS. 
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8.0 ERROR CONDITIONS 

8.1 DEFINITION OF CODES 



To be supDlired. 
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13 

Ik 

15 

16 

17 

18 

19 

20 

21 

22 

23 

2tf 

25 

26 

27 

28 

29 

30 

31 

32 

33 
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